home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / source / machine / vax / vms.doc < prev    next >
Text File  |  1994-01-29  |  5KB  |  104 lines
  1. This file contains the documentation specific to the VMS version of POV-Ray.
  2.  
  3. Note: PLEASE SEE POVLEGAL.DOC.  The VMS version in ZIP format is an
  4.    officially supported format and can be distributed as is.  You MAY NOT
  5.    re-package the archive file or distribute any changes to it.  If you
  6.    do post it on a BBS or network, you must provide at least the data
  7.    files and documentation files with the executables.  See POVLEGAL.DOC
  8.    for complete details.
  9.  
  10. Testing:
  11.    This version of POV-Ray for the VAX may only have been tested on an
  12.    Alpha AXP 500 running OpenVMS 1.5. It may need tweaking for your compiler.
  13.  
  14. Executables:
  15.    At this stage, no executables are provided.
  16.  
  17. ** ALPHA USERS ***
  18.    Please ensure you #define ALPHA in vaxconf.h (config.h).
  19.    This will avoid a whole heap of warnings when you compile.
  20.  
  21. ** Known Bug on ALPHA **
  22.    When you use the +B option to set a buffer > 64kB on the DEC Alpha running
  23.    OpenVMS 1.5, the program will halt when 65kB of data has been buffered.
  24.    This seems to be a problem with either DEC's implementation of setvbuf ()
  25.    or the file buffering associated with file output.
  26.    Solution : keep the bufer size < 65kB.
  27.  
  28. Running POV-Ray:
  29.    Assign a foreign symbol to the executable. The syntax is:
  30.       povray :== $<your_disk>:[<directory>]povray
  31.    An example symbol might look like:
  32.       povray :== $dua100:[povray.build]povray
  33.    or
  34.       povray :== $dua100:[povray.build]povray +w320 +h200 +d +v [for example]
  35.  
  36.    You may also like to add your include file path to the symbol.
  37.    When running POV-Ray, be sure that you have a large working set.
  38.    You will need to use the '+d' option for the X version to display anything.
  39.  
  40. File Formats:
  41.    The default file format for the Vax is "targa" format (+ft).
  42.    Dump or raw may be specified on the command line or in the
  43.    povray.def file. The TGA2GIF program (not included in this archive)
  44.    may be used to convert the output to a GIF file.
  45.  
  46. Building the source:
  47.    To compile POV-Ray from the original source, follow the following instructions:
  48.    You will of course need a properly set up C compiler.
  49.  
  50.    If you want to use the X version you will need X and the X libraries.
  51.    You may need to edit the POVRAY.OPT file for your X library path.
  52.    Motif is NOT needed, as POV runs with X and Xt only.
  53.  
  54.    #define X_GETS_ARGS in vaxconf.h if you want to use X options such as
  55.    '-display xxx:n.n'. Note that some may conflict with POV options.
  56.  
  57.      1) create a [.source] directory.
  58.  
  59.      2) copy the files from POVSRC.ZIP's SOURCE directory into this directory.
  60.  
  61.      3) copy the files from POVSRC.ZIP's MACHINE\VAX directory into [.source].
  62.  
  63.      4) rename vaxconf.h to config.h
  64.  
  65.      5) execute "@vaxbuild" for a NON XWindows executable.
  66.  
  67.      6) execute "@xvaxbld" for an XWindows executable.
  68.  
  69.    Note that if you switch between X and non-X versions you MUST recompile
  70.    ALL FILES.
  71.  
  72. Post-processing Images:
  73.    POV-Ray images can be post-processed using the PBMPLUS utilities.
  74.    The program TGA2GIF (source available on Compuserve in GRAPHDEV section 8
  75.    as TGAGI2.ZIP) will run on a VAX and does a nice job of converting Targa
  76.    output files into GIF files.
  77.  
  78. Displaying Images:
  79.    There are various programs around that can display GIF files under X
  80.    windows. At a later stage I may upload one into GRAPHDEV, so have a look.
  81.    Some DECwindows systems come with a program called PICT.EXE, which will do a
  82.    good job of displaying GIF files, also.
  83.  
  84.    For those with a Postscipt printer, you can use PBMPLUS to convert POV-Ray
  85.    files to Postscript and then print them.
  86.  
  87. The VMS X Windows code was developed and tested by Christopher J. Cason under
  88. DECWindows on a DEC Alpha AXP 500 running OpenVMS 1.5.
  89.  
  90. Questions and problems in the VAX/VMS version can be directed to Chris Cason on
  91. Compuserve via mail or in the POV source section of GRAPHDEV. (currently 8).
  92.  
  93. I will continue to enhance this code and test it other machines.
  94. If you had to make any modifications to get it to compile, please let me know
  95. so that I may update this source accordingly. This particularly applies to
  96. the build files. By doing so, you will be helping others.
  97.  
  98. If you have any problems getting it to build, you may like to contact me or
  99. check the POV section of GRAPHDEV on Compuserve to see if there are updated
  100. files. Try scanning for the keyword VMS or XWINDOWS.
  101.  
  102. Chris Cason.
  103. CIS:100032,1644
  104. Internet:100032.1644@compuserve.com